Skip to content

Enhanced Installation, Planner Agent & Builder Upgrades#1

Open
jamalcodez wants to merge 10 commits intoclean-mainfrom
update-installation-docs
Open

Enhanced Installation, Planner Agent & Builder Upgrades#1
jamalcodez wants to merge 10 commits intoclean-mainfrom
update-installation-docs

Conversation

@jamalcodez
Copy link
Owner

@jamalcodez jamalcodez commented Aug 26, 2025

Summary

Comprehensive improvements to the ADCE Framework with enhanced installation experience, new planner agent, and upgraded builder capabilities:

  • Installation Documentation: Complete INSTALL.md with multiple methods and troubleshooting
  • Planner Agent: NEW agent for breaking PRPs into dependency-aware implementation tasks
  • Builder Agent Upgrade: 2025 design patterns, modern UI capabilities, accessibility features
  • Package Updates: Improved CLI command naming (adce-framework)
  • Documentation: Enhanced examples with real-world task breakdown workflows

Key Features

📚 Installation Improvements

  • ✅ New INSTALL.md with step-by-step instructions
  • ✅ Multiple installation methods (npm, git clone, manual)
  • ✅ Troubleshooting guide and verification steps
  • ✅ Updated README with clearer quick start

🤖 NEW: Planner Agent

  • ✅ Breaks complex PRPs into specific implementation tasks
  • ✅ Dependency-aware task sequencing
  • ✅ Complete expense tracking API example (1,024 lines)
  • ✅ Reusable task plan templates

🎨 Builder Agent Enhancements

  • ✅ 2025 design patterns and modern UI capabilities
  • ✅ WCAG 2.1 AA accessibility compliance
  • ✅ Design system integration
  • ✅ Component composition patterns
  • ✅ Performance optimization strategies

🔧 Package Configuration

  • ✅ Updated bin command to adce-framework
  • ✅ Improved package metadata
  • ✅ Better CLI tooling

Changes

  • 16 files modified
  • 3,030+ lines added
  • 130 lines removed

Files Changed

  • INSTALL.md (new) - Comprehensive installation guide
  • agents/planner.md (new) - Task breakdown agent
  • agents/builder.md - Upgraded with 2025 patterns
  • examples/task-breakdown/ (new) - Complete workflow examples
  • templates/task-plan/ (new) - Reusable templates
  • package.json, package-lock.json - CLI improvements
  • README.md, documentation updates

Test Plan

  • Installation methods tested
  • Planner agent workflow verified with expense API example
  • Builder agent enhancements validated
  • Documentation accuracy reviewed
  • CLI commands work correctly

🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

jamalcodez and others added 9 commits August 25, 2025 06:18
- Add global installation option (npm install -g + adce install)
- Keep local installation option for project-specific use
- Improve Quick Start section structure

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
…bilities

- Enhanced builder agent with cutting-edge 2025 design patterns including vivid glow aesthetics, anti-design/brutalism, and human-crafted authenticity
- Added advanced interactivity patterns: dynamic cursors, 3D elements, micro-interactions 2.0
- Integrated AI & accessibility features with WCAG 2.2 compliance and voice interfaces
- Included sustainability and ethical design principles for energy-efficient development
- Added comprehensive 2025 component pattern library with CSS examples
- Updated success metrics to include modern standards and progressive enhancement

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Updated agent specifications with comprehensive 2025 design pattern integration
- Enhanced agents README with modern builder capabilities
- Added 2025 design patterns example directory with usage guidelines
- All agents pass validation with only minor enhancement suggestions

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This enhancement adds granular task decomposition capabilities to ADCE:

New Components:
- Planner agent: Breaks PRPs into 5-15 specific, dependency-aware tasks
- Task plan template: Structured format with dependency tracking
- Task breakdown example: Complete workflow showing planning in action

Updated Documentation:
- Added Phase 3 (Task Planning) to methodology
- Updated README.md and agents/README.md to include planner
- Modified install.js to install planner agent and task-plan templates
- Updated CLAUDE.md template with extended workflow

Key Features:
- Dependency mapping (identifies which tasks block others)
- Time estimation per task (1-4 hour chunks)
- Verification criteria for each task
- Circuit breaker integration (P1/P2/P3 priority system)
- Parallel work opportunities identification

Benefits:
- Systematic execution with clear step-by-step path
- Better progress tracking (7/12 tasks = 58% done)
- Early risk detection (task overruns trigger circuit breakers)
- Enables parallel work across multiple developers
- Improved AI results through specific task prompts

Usage:
Use for complex features (1-2+ week appetite), skip for simple features.
Example: "Use planner to break down the API PRP into specific tasks"

Generated with Claude Code
Fixes:
- Fixed "could not determine executable to run" error
- Removed reference to non-existent tools/cli.js
- Simplified bin configuration to point to install.js
- Updated installation command from 'npx adce-framework install' to 'npx adce-framework'

README Improvements:
- Added planner agent to workflow examples
- Fixed section headers (Why ADCE Works, Real Results, etc.)
- Improved list formatting throughout
- Added proper markdown structure

Users can now install with:
  npx adce-framework

Generated with Claude Code
Created INSTALL.md with:
- Clear explanation that ADCE runs INSIDE Claude Code
- Three installation methods (npm/git/manual)
- Step-by-step instructions for each method
- Troubleshooting section
- Publishing guide for maintainers
- Usage examples

Updated README.md to:
- Clarify that agents run inside Claude Code
- Show current installation method (pre-npm)
- Show future installation method (post-npm)
- Link to detailed INSTALL.md guide
- Emphasize Claude Code requirement

This addresses confusion about npx not working - package needs to be
published to npm first. Current users should use git clone method.

🤖 Generated with Claude Code
Changes the CLI command from 'adce' to 'adce-framework' and removes the separate adce-install command, consolidating to a single entry point through install.js for better package management and clarity.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Combines installation documentation improvements with builder agent upgrades:
- Installation guide with multiple methods (INSTALL.md)
- Planner agent and task breakdown system
- Builder agent with 2025 design patterns
- GitHub issue templates and CI workflow
- Updated package configuration

Resolved conflicts in README.md by merging both installation instruction sets.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@jamalcodez jamalcodez changed the title Update installation instructions Enhanced Installation, Planner Agent & Builder Upgrades Oct 28, 2025
Replaces separate "Standard Flow" and "Extended Flow" with a single unified workflow that includes the planner agent as a standard step. The planner step can be skipped for very simple features.

**Unified Flow**: shaper → architect → planner → builder/deployer → integration

Changes:
- Updated README.md with numbered workflow steps
- Updated agents/README.md with unified flow
- Updated docs/agent-specifications.md with planner in sequential handoffs
- Updated install.js CLAUDE.md template with unified flow

Rationale: Having two separate flows was confusing. The new unified flow makes planner a standard step with clear guidance on when it can be skipped (single file, <2 hour tasks).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants